home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 001-025 / disk_006 / compress / btoa.man < prev    next >
Text File  |  1992-05-06  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4.      BBBBTTTTOOOOAAAA((((1111))))                 UUUUNNNNIIIIXXXX 5555....0000 ((((llllooooccccaaaallll))))                  BBBBTTTTOOOOAAAA((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           btoa, atob, tarmail, untarmail - encode/decode binary to
  10.           printable ASCII
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           bbbbttttooooaaaa
  14.           aaaattttoooobbbb
  15.           ttttaaaarrrrmmmmaaaaiiiillll who subject files ...
  16.           uuuunnnnttttaaaarrrrmmmmaaaaiiiillll [ file ]
  17.  
  18.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.           _B_t_o_a is a filter that reads anything from the standard
  20.           input, and encodes it into printable ASCII on the standard
  21.           output.  It also attaches a header and checksum information
  22.           used by the reverse filter _a_t_o_b to find the start of the
  23.           data and to check integrity.
  24.  
  25.           _A_t_o_b reads an encoded file, strips off any leading and
  26.           trailing lines added by mailers, and recreates a copy of the
  27.           original file on the standard output.  _A_t_o_b gives NO output
  28.           (and exits with an error message) if its input is garbage or
  29.           the checksums do not check.
  30.  
  31.           _T_a_r_m_a_i_l is a shell script that tar's up all the given files,
  32.           pipes them through _c_o_m_p_r_e_s_s, _b_t_o_a, and mails them to the
  33.           given person with the given subject phrase.  For example:
  34.  
  35.                tarmail ralph "here it is ralph" foo.c a.out
  36.  
  37.           Will package up files "foo.c" and "a.out" and mail them to
  38.           "ralph" using subject "here it is ralph".  Notice the quotes
  39.           on the subject.  They are necessary to make it one argument
  40.           to the shell.
  41.  
  42.           _T_a_r_m_a_i_l with no args will print a short message reminding
  43.           you what the required args are.  When the mail is received
  44.           at the other end, that person should use mail to save the
  45.           message in some temporary file name (say "xx").  Then saying
  46.           "untarmail xx" will decode the message and untar it.
  47.           _U_n_t_a_r_m_a_i_l can also be used as a filter.  By using _t_a_r_m_a_i_l,
  48.           binary files and entire directory structures can be easily
  49.           transmitted between machines.  Naturally, you should
  50.           understand what tar itself does before you use _t_a_r_m_a_i_l.
  51.  
  52.           Other uses:
  53.  
  54.           compress < secrets | crypt | btoa | mail ralph
  55.  
  56.           will mail the encrypted contents of the file "secrets" to
  57.           ralph.  If ralph knows the encryption key, he can decode it
  58.           by saving the mail (say in "xx"), and then running:
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 1/1/86)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      BBBBTTTTOOOOAAAA((((1111))))                 UUUUNNNNIIIIXXXX 5555....0000 ((((llllooooccccaaaallll))))                  BBBBTTTTOOOOAAAA((((1111))))
  71.  
  72.  
  73.  
  74.           atob < xx | crypt | uncompress
  75.  
  76.           (crypt requests the key from the terminal, and the "secrets"
  77.           come out on the terminal).
  78.  
  79.      AAAAUUUUTTTTHHHHOOOORRRR
  80.           Paul Rutter (modified by Joe Orost)
  81.  
  82.      FFFFEEEEAAAATTTTUUUURRRREEEESSSS
  83.           _B_t_o_a uses a compact base-85 encoding so that 4 bytes are
  84.           encoded into 5 characters (file is expanded by 25%).  As a
  85.           special case, 32-bit zero is encoded as one character.  This
  86.           encoding produces less output than _u_u_e_n_c_o_d_e(1).
  87.  
  88.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  89.           compress(1), crypt(1), uuencode(1), mail(1)
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 1/1/86)
  130.  
  131.  
  132.  
  133.